package com.psnoted.backend.repository;

import com.psnoted.backend.entity.UserData;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 用户数据Repository接口
 * 提供用户数据存储访问方法
 * 
 * @author PSNoted Team
 * @version 1.0.0
 */
@Repository
public interface UserDataRepository extends JpaRepository<UserData, Long> {

    /**
     * 根据密钥哈希查找最新的用户数据
     * 
     * @param keyHash 密钥哈希
     * @return 最新的用户数据
     */
    @Query("SELECT ud FROM UserData ud WHERE ud.keyHash = :keyHash ORDER BY ud.timestamp DESC")
    Optional<UserData> findLatestByKeyHash(@Param("keyHash") String keyHash);

    /**
     * 根据密钥哈希查找所有用户数据（按时间戳降序）
     * 
     * @param keyHash 密钥哈希
     * @return 用户数据列表
     */
    @Query("SELECT ud FROM UserData ud WHERE ud.keyHash = :keyHash ORDER BY ud.timestamp DESC")
    List<UserData> findAllByKeyHashOrderByTimestampDesc(@Param("keyHash") String keyHash);

    /**
     * 根据密钥哈希和时间戳查找用户数据
     * 
     * @param keyHash 密钥哈希
     * @param timestamp 时间戳
     * @return 用户数据
     */
    Optional<UserData> findByKeyHashAndTimestamp(String keyHash, Long timestamp);

    /**
     * 根据密钥哈希查找指定版本的用户数据
     * 
     * @param keyHash 密钥哈希
     * @param version 数据版本
     * @return 用户数据列表
     */
    List<UserData> findByKeyHashAndVersionOrderByTimestampDesc(String keyHash, String version);

    /**
     * 检查指定密钥哈希是否有数据
     * 
     * @param keyHash 密钥哈希
     * @return 是否有数据
     */
    boolean existsByKeyHash(String keyHash);

    /**
     * 根据密钥哈希删除所有用户数据
     * 
     * @param keyHash 密钥哈希
     */
    void deleteByKeyHash(String keyHash);

    /**
     * 根据密钥哈希统计数据数量
     * 
     * @param keyHash 密钥哈希
     * @return 数据数量
     */
    long countByKeyHash(String keyHash);
} 